home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / catD / hwgraph.net.z / hwgraph.net
Encoding:
Text File  |  2002-10-03  |  5.7 KB  |  133 lines
  1.  
  2.  
  3.  
  4. hhhhwwwwggggrrrraaaapppphhhh....nnnneeeetttt((((DDDD3333XXXX))))                                              hhhhwwwwggggrrrraaaapppphhhh....nnnneeeetttt((((DDDD3333XXXX))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      _hhhh_wwww_gggg_rrrr_aaaa_pppp_hhhh_...._nnnn_eeee_tttt_:::: if_hwgraph_add, if_hwgraph_alias_add,
  10.      if_hwgraph_alias_remove - network device information
  11.  
  12. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  13.      ####iiiinnnncccclllluuuuddddeeee <<<<ssssyyyyssss////ttttyyyyppppeeeessss....hhhh>>>>
  14.      ####iiiinnnncccclllluuuuddddeeee <<<<ssssyyyyssss////hhhhwwwwggggrrrraaaapppphhhh....hhhh>>>>
  15.      ####iiiinnnncccclllluuuuddddeeee <<<<ssssyyyyssss////ddddddddiiii....hhhh>>>>
  16.      ####iiiinnnncccclllluuuuddddeeee <<<<ssssyyyyssss////iiiinnnnvvvveeeennnntttt....hhhh>>>>
  17.      ####iiiinnnncccclllluuuuddddeeee <<<<nnnneeeetttt////iiiiffff....hhhh>>>>
  18.  
  19.      ggggrrrraaaapppphhhh____eeeerrrrrrrroooorrrr____tttt
  20.      iiiiffff____hhhhwwwwggggrrrraaaapppphhhh____aaaadddddddd((((vvvveeeerrrrtttteeeexxxx____hhhhddddllll____tttt _p_a_r_e_n_t,,,,
  21.                           cccchhhhaaaarrrr ****_p_a_t_h,,,,
  22.                           cccchhhhaaaarrrr ****_p_r_e_f_i_x,,,,
  23.                           cccchhhhaaaarrrr ****_a_l_i_a_s,,,,
  24.                           vvvveeeerrrrtttteeeexxxx____hhhhddddllll____tttt ****_r_e_t))));;;;
  25.  
  26.      ggggrrrraaaapppphhhh____eeeerrrrrrrroooorrrr____tttt
  27.      iiiiffff____hhhhwwwwggggrrrraaaapppphhhh____aaaalllliiiiaaaassss____aaaadddddddd((((vvvveeeerrrrtttteeeexxxx____hhhhddddllll____tttt _t_a_r_g_e_t,,,, cccchhhhaaaarrrr ****_a_l_i_a_s))));;;;
  28.  
  29.      ggggrrrraaaapppphhhh____eeeerrrrrrrroooorrrr____tttt
  30.      iiiiffff____hhhhwwwwggggrrrraaaapppphhhh____aaaalllliiiiaaaassss____rrrreeeemmmmoooovvvveeee((((cccchhhhaaaarrrr ****_p_a_t_h))));;;;
  31.  
  32.    AAAArrrrgggguuuummmmeeeennnnttttssss
  33.      _a_l_i_a_s       The alias to be inserted in /_h_w/_n_e_t.
  34.  
  35.      _p_a_r_e_n_t      The attachment point of the device.
  36.  
  37.      _p_a_t_h        A character string representing a path in the hardware graph.
  38.  
  39.      _p_r_e_f_i_x      The string from the _P_R_E_F_I_X field of the _m_a_s_t_e_r file.
  40.  
  41.      _r_e_t         A vertex representing the device itself.
  42.  
  43.      _t_a_r_g_e_t      A character string representing the target of a link in the
  44.                  hardware graph.
  45.  
  46. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  47.      These functions provide ancillary hardware graph support for networking
  48.      devices.
  49.  
  50.      _i_f__h_w_g_r_a_p_h__a_d_d
  51.           This routine provides rudimentary support for legacy networking
  52.           devices.  It creates an entry for the device in the hardware graph,
  53.           attached to _p_a_r_e_n_t. An entry under /_h_w/_n_e_t is created for _a_l_i_a_s.
  54.           The device must be designated as a character device in its _m_a_s_t_e_r
  55.           file.
  56.  
  57.      if_hwgraph_alias_add
  58.           This routine can be used by a device driver to create an alias for
  59.           itself in /_h_w/_n_e_t.  The _t_a_r_g_e_t argument should be the device itself.
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. hhhhwwwwggggrrrraaaapppphhhh....nnnneeeetttt((((DDDD3333XXXX))))                                              hhhhwwwwggggrrrraaaapppphhhh....nnnneeeetttt((((DDDD3333XXXX))))
  71.  
  72.  
  73.  
  74.      if_hwgraph_alias_remove
  75.           This routine can be used to remove an alias in the event that the
  76.           device is unloaded.
  77.  
  78. DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
  79.      These routines return GRAPH_SUCCESS if successful.  Otherwise, the
  80.      following diagnostics can be returned:
  81.  
  82.      GRAPH_CANNOT_ALLOC
  83.           Initialization of the underlying networking hardware graph failed.
  84.  
  85.      GRAPH_DUP
  86.           The specified path already exists.
  87.  
  88.      GRAPH_NOT_FOUND
  89.           An attempt was made to remove an alias when it did not exist.
  90.  
  91. NNNNOOOOTTTTEEEESSSS
  92.      Devices with full support for the hardware graph should not normally need
  93.      to use _i_f__h_w_g_r_a_p_h__a_d_d.
  94.  
  95.      The aliases in /_h_w/_n_e_t are currently a convenience for system
  96.      administrators.  In future versions of IRIX, they may be required by
  97.      system utilities.  Developers are encouraged to support them in their
  98.      drivers.
  99.  
  100. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  101.      hinv(1), ioconfig(1), getinvent(3), hwgraph.dev(D3X),
  102.      hwgraph.legacy(D3X), hwgraph.intro(D4X).
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.